From: Wei Liu Date: Fri, 20 Oct 2017 16:30:41 +0000 (+0100) Subject: docs: update coverage.markdown X-Git-Tag: archive/raspbian/4.11.1-1+rpi1~1^2~66^2~1072 X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/%22bookmarks://%22Dat/%22http:/www.example.com/cgi/%22https:/%22bookmarks:/%22Dat?a=commitdiff_plain;h=e1bc61af7621ee07f7ba03afcfa4b6fa54fbfb2a;p=xen.git docs: update coverage.markdown The coverage support in hypervisor is redone. Update the document. Signed-off-by: Wei Liu Acked-by: Ian Jackson Reviewed-by: Roger Pau Monné --- diff --git a/docs/misc/coverage.markdown b/docs/misc/coverage.markdown index 9a88c899b8..6eae44176c 100644 --- a/docs/misc/coverage.markdown +++ b/docs/misc/coverage.markdown @@ -10,38 +10,26 @@ down your hypervisor. ## Enable coverage -Test coverage support can be turned on compiling Xen with the `coverage` option set -to `y`. +Test coverage support can be turned on compiling Xen with the `CONFIG_GCOV` +option set to `y`. -Something like: - - cd xen - make coverage=y - -(or change your `.config` file). +Change your `.config` or run `make -C xen menuconfig`. ## Extract coverage data -The way GCC and other tools deal with coverage information is to use some files -created during build phase (.gcno) and some files produced by executing the -*program* (.gcda). The program in this case is Xen but Xen cannot write files -so the way you can use coverage from Xen is extract coverage data from Xen and -then split these information into files. - -To extract data you use a simple utility called `xencov`. Mainly `xencore` -allows you to do 3 operations: +To extract data you use a simple utility called `xencov`. +It allows you to do 2 operations: * `xencov read` extract data * `xencov reset` reset all coverage counters -* `xencov read-reset` extract data and reset counters at the same time. -Another utility (`xencov_split`) is used to split extracted data file into files -needed by userspace tools. +Another utility (`xencov_split`) is used to split extracted data file into +files needed by userspace tools. ## Split coverage data -Once you extracted data from Xen, it is time to create files which the coverage tools -can understand. To do it you need to run `xencov_split` utility. +Once you extracted data from Xen, it is time to create files which the coverage +tools can understand. To do it you need to run `xencov_split` utility. The utility just takes an input file and splits the blob into gcc .gcda files in the same directory that you execute the script. As file names are generated